---
title: Discord
description: Discordとの連携
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="discord"
  color="#5865F2"
  icon={true}
  iconSvg={`<svg className="block-icon"
      
      
      
      viewBox='0 -28.5 256 256'
      version='1.1'
      xmlns='http://www.w3.org/2000/svg'
      xmlnsXlink='http://www.w3.org/1999/xlink'
      preserveAspectRatio='xMidYMid'
    >
      <g>
        <path
          d='M216.856339,16.5966031 C200.285002,8.84328665 182.566144,3.2084988 164.041564,0 C161.766523,4.11318106 159.108624,9.64549908 157.276099,14.0464379 C137.583995,11.0849896 118.072967,11.0849896 98.7430163,14.0464379 C96.9108417,9.64549908 94.1925838,4.11318106 91.8971895,0 C73.3526068,3.2084988 55.6133949,8.86399117 39.0420583,16.6376612 C5.61752293,67.146514 -3.4433191,116.400813 1.08711069,164.955721 C23.2560196,181.510915 44.7403634,191.567697 65.8621325,198.148576 C71.0772151,190.971126 75.7283628,183.341335 79.7352139,175.300261 C72.104019,172.400575 64.7949724,168.822202 57.8887866,164.667963 C59.7209612,163.310589 61.5131304,161.891452 63.2445898,160.431257 C105.36741,180.133187 151.134928,180.133187 192.754523,160.431257 C194.506336,161.891452 196.298154,163.310589 198.110326,164.667963 C191.183787,168.842556 183.854737,172.420929 176.223542,175.320965 C180.230393,183.341335 184.861538,190.991831 190.096624,198.16893 C211.238746,191.588051 232.743023,181.531619 254.911949,164.955721 C260.227747,108.668201 245.831087,59.8662432 216.856339,16.5966031 Z M85.4738752,135.09489 C72.8290281,135.09489 62.4592217,123.290155 62.4592217,108.914901 C62.4592217,94.5396472 72.607595,82.7145587 85.4738752,82.7145587 C98.3405064,82.7145587 108.709962,94.5189427 108.488529,108.914901 C108.508531,123.290155 98.3405064,135.09489 85.4738752,135.09489 Z M170.525237,135.09489 C157.88039,135.09489 147.510584,123.290155 147.510584,108.914901 C147.510584,94.5396472 157.658606,82.7145587 170.525237,82.7145587 C183.391518,82.7145587 193.761324,94.5189427 193.539891,108.914901 C193.539891,123.290155 183.391518,135.09489 170.525237,135.09489 Z'
          fill='currentColor'
          fillRule='nonzero'
        />
      </g>
    </svg>`}
/>

{/* MANUAL-CONTENT-START:intro */}
[Discord](https://discord.com)は、友人、コミュニティ、チームとつながることができる強力なコミュニケーションプラットフォームです。テキストチャンネル、ボイスチャンネル、ビデオ通話など、チームコラボレーションのための様々な機能を提供しています。

Discordアカウントまたはボットを使用すると、以下のことができます：

- **メッセージの送信**: 特定のチャンネルにメッセージを送信する
- **メッセージの取得**: 特定のチャンネルからメッセージを取得する
- **サーバーの取得**: 特定のサーバーに関する情報を取得する
- **ユーザーの取得**: 特定のユーザーに関する情報を取得する

Simでは、Discord連携によりエージェントが組織のDiscordサーバーにアクセスして活用することができます。エージェントはDiscordチャンネルから情報を取得したり、特定のユーザーを検索したり、サーバー情報を取得したり、メッセージを送信したりすることができます。これにより、ワークフローをDiscordコミュニティと統合し、通知を自動化し、インタラクティブな体験を作成することができます。

> **重要:** メッセージの内容を読むには、DiscordボットがDiscord開発者ポータルで「メッセージコンテンツインテント」を有効にする必要があります。この権限がないと、メッセージのメタデータは受信できますが、コンテンツフィールドは空になります。

SimのDiscordコンポーネントは効率的な遅延読み込みを使用し、必要な時だけデータを取得することでAPI呼び出しを最小限に抑え、レート制限を防ぎます。トークンの更新はバックグラウンドで自動的に行われ、接続を維持します。

### Discordボットの設定

1. [Discord開発者ポータル](https://discord.com/developers/applications)にアクセスします
2. 新しいアプリケーションを作成し、「Bot」タブに移動します
3. ボットを作成し、ボットトークンをコピーします
4. 「特権ゲートウェイインテント」で、メッセージ内容を読み取るための**メッセージコンテンツインテント**を有効にします
5. 適切な権限でボットをサーバーに招待します
{/* MANUAL-CONTENT-END */}

## 使用方法

Discordをワークフローに統合します。メッセージの送受信、サーバー情報の取得、ユーザー情報の取得が可能です。ボットAPIキーが必要です。

## ツール

### `discord_send_message`

Discordチャンネルにメッセージを送信する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | はい | 認証用のボットトークン |
| `channelId` | string | はい | メッセージを送信するDiscordチャンネルID |
| `content` | string | いいえ | メッセージのテキスト内容 |
| `serverId` | string | はい | DiscordサーバーID（ギルドID） |
| `files` | file[] | いいえ | メッセージに添付するファイル |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功またはエラーメッセージ |
| `data` | object | Discordメッセージデータ |

### `discord_get_messages`

Discordチャンネルからメッセージを取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | はい | 認証用のボットトークン |
| `channelId` | string | はい | メッセージを取得するDiscordチャンネルID |
| `limit` | number | いいえ | 取得するメッセージの最大数（デフォルト：10、最大：100） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功またはエラーメッセージ |
| `messages` | array | 完全なメタデータを含むDiscordメッセージの配列 |

### `discord_get_server`

Discordサーバー（ギルド）に関する情報を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | はい | 認証用のボットトークン |
| `serverId` | string | はい | DiscordサーバーID（ギルドID） |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功またはエラーメッセージ |
| `data` | object | Discordサーバー（ギルド）情報 |

### `discord_get_user`

Discordユーザーに関する情報を取得する

#### 入力

| パラメータ | 型 | 必須 | 説明 |
| --------- | ---- | -------- | ----------- |
| `botToken` | string | はい | 認証用のDiscordボットトークン |
| `userId` | string | はい | DiscordユーザーID |

#### 出力

| パラメータ | 型 | 説明 |
| --------- | ---- | ----------- |
| `message` | string | 成功またはエラーメッセージ |
| `data` | object | Discordユーザー情報 |

## 注意事項

- カテゴリー: `tools`
- タイプ: `discord`
